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1.0. Introduction 


Thank you for purchasing Supermorse! I hope that it will bring many hours of 
enjoyment to your CW operating activity. Supermorse is a tightly written, highly 
optimized application. This allows it to make the most of any system it is run on. 
You will find many features that make CW a pleasure for both casual rag-chewing 
and contest operation. Please take a few minutes to read over this manual before 
beginning. It is designed to help you get the most out of your software investment 
as quickly as possible. - AD4YH 


2.0. System requirements 


2.1. Hardware 

Supermorse is written for the IBM PC and compatibles. This application was 
designed to operate on the widest variety of systems possible. The minimum 
system required is: 


IBM PC or compatible 

286 or greater 

640 K memory (1 megabyte optional) 

Serial port (two for mouse operation) 

Parallel printer port (for printing from text editor) 

One 5.25 or 3.5" floppy drive (for installation and key operation) * 

Hard drive (for program operation) 

Color (CGA, EGA, VGA ) or monochrome display adapter 

(Color is suggested but not necessary.) 

e Microsoft or compatible two button mouse (If mouse operation is desired.) 


* Supermorse is supplied on 3.5" diskettes. 5.25" is available upon request. 


2.2. Operating system 

Supermorse will run on version DOS 3.1 or greater. Versions 5 and 6.x will 
provide the best environment. It is suggested that Supermorse be run directly from 
the DOS prompt and not from Windows. Supermorse is a real-time application and 
requires direct access to many of the functions on the system board, as well as 
direct access to the CPU itself. 


We now support current versions of Windows XP and Vista. 


4.0 Installation 


The only requirement for the Supermorse system is that it be installed in a 
directory called "supermse". It will run if it is not, but the help file and macro 
system features will not function. 


3.0. System configuration 


A straight foreword system configuration is all that is required. As a general rule 
keep the configuration as simple as possible. The CONFIG.SYS file should have a 
minimum of statements in it. Don't have a lot of various device drivers that your 
system will not be using for Supermorse. Never mind this if you are running 
Windows XP or Vista. 


If you plan to use the mouse feature of Supermorse you must be sure to install a 
mouse device driver in either your CONFIG.SYS or AUTOEXEC.BAT files. 
Which one will depend on the type of driver that you have. Otherwise Supermorse 
will issue an error message at run-time indicating that it could not find the mouse 
driver. 


With DOS 5 and 6, loading DOS in the high memory area of your system (above 
640 k) will free up the lower area of memory for Supermorse to use. Also, the use 
of Smartdrive may prove useful in speeding up certain file operations. Refer to 
your DOS users manual for these. Never mind this if you are running Windows 
XP or Vista. 


5.0. Running the program 


5.1. Starting Supermse 

To run Supermorse place the distribution/key disk in one of the floppy drives and 
go to the "supermse" directory (cd\supermse) and type "supermse". This will start 
the program in the default mode. It commences operation by first searching your 
system's floppy drives for the distribution/key disk. When the distribution disk is 
found Supermorse checks the disk for valid operation rights. If the check shows 
valid rights the program will continue to run, otherwise operation is ended. 


It is not necessary to keep the distribution disk in the floppy after the program has 
successfully started. It is only necessary for initially running the program. 


5.2. Command line parameters 

Supermorse is designed to accept various command line parameters. This gives the 
ability to customize the operation of the program. These are listed and explained 
below: 


5.2.1. Parameter 1- nobeep 
This causes Supermorse to start operation with the computer sidetone muted. The 
sidetone may be restored after the program is run with the F3 key. 


5.2.2. Parameter 2 - clone 

This parameter is for systems not 100% IBM compatible. In the default mode 
Supermorse writes directly to the display adapter memory for fast screen updates. 
This parameter causes screen updates to be routed via the bios routines. This will 
result in a much slower screen update. Try your system without this parameter 
first. Many systems will exhibit no difficulties running Supermorse. 


5.2.5. Parameter 5 - help 
A sign-on help screen giving a brief summary of this information is activated. 


Any number of these parameters may be specified in any order on the command 
line. If any are omitted the opposite or "default" state will result. 


Example: C:\SUPERMSE\supermse nobeep mouse 
This example activates Supermorse in the mouse mode with the sidetone muted. 
6.0. Modes of operation 


6.1. Interactive sending 

This is the default mode when Supermorse is started. It is the heart of the 
application. All of the other modes are accessed from this point. When you are 
here, you may begin sending code by just typing away at the keyboard. Typing 
may be as fast or as slow as desired. You are not typing characters directly on the 
air, but rather into a continuos ring type buffer which in turn sends the characters 
out over the air at the desired preset speed. Type away as you will, and 
Supermorse will follow diligently along behind you consistently at the exact speed 
Set. 


On a color monitor characters not sent are white with a red background. After they 
are actually sent out, the background changes to the "battleship gray" of the rest of 
the screen. 


Controls that have "Ctrl" or "Alt" in them require the Ctrl or Alt keys to be pressed 
first before the command key. When Ctrl or Alt is pressed a small pop-up type 


message appears in red located at the bottom right of the screen frame. 


Mouse operation 


The different areas of the screen frame are geographically defined for mouse 
usage. Descriptions are given first as they apply to the keyboard, then "mouse" 
control is explained where it applies. 
6.1.1. Overall description of controls 


The figure below shows the main screen of Supermorse for reference during this 
discussion. 


Esc=Exit !=Wait @=Error Supermorse Terminal End-> #=Msg $=Work Wpm=20 


Time: 09:48:23 Hot Keys: Alt F1-F12 Help: Alt HC K Date: 05/29 


This text is shown in the working area of the screen. 
The boxed areas at the top and bottom contain various 
text objects for mode and setup changes. These text 
objects are mouse-able if a mouse driver is installed 
in the system. Other displays in the boxed areas pro- 
vide various information depending on the selected 
mode. 


Fl Lin F2 °: ¥F3 F4  :: #F5 F6 F7 -:: F8 F9 F10 
On/Off Lower Higher Slower Faster Send File Save<--Edit Dir/Sys Clear 





The following discussion explains each of the controls and features accessible 
from the main screen beginning with the function keys. 


6.1.1.1. Fl - On and off line 

This control places the transmitter on line. Keying is sent through the transmitter 
interface. When in the on line mode the F1 control is highlighted in red. 

Mouse operation- Place the mouse cursor directly over "F1 Lin" on the screen and 
press the left button. To release with the mouse press either button. 

6.1.1.2. Ctrl FI - Tune 

This is a transmitter tuning mode. It creates a "key down" condition for tuning and 
testing. When it is activated a pop-up message appears "Tune" at the bottom center 
of the screen frame. Tune mode is released by pressing any key. It is not 


recommended to use the tune mode for extended periods if the interface is battery 
powered. Also damage to transmitting equipment may result for various reasons. 


Mouse operation- Place the mouse cursor on the "F1". First press the right button 
and while holding it press the left button. Press either button to release the tune 
condition. 


6.1.1.3. F2 & F3 - Sidetone control 

These provide adjustment up and down of the pitch of the sidetone. When 
Supermorse is started the pitch defaults to 440 cps, concert "A". If Supermorse is 
started with the "nobeep" option the sidetone may be restored with the F3 key. If 
the sidetone is adjusted while the program is sending characters from the buffer, 
the tone will be heard changing as the characters are sent. If no sending is taking 
place, the program produces short "dits" as the tone changes. 


Mouse operation- Place the mouse cursor directly over either F2 or F3 and hold 
the left button. 


6.1.1.4. F4 & F5 - Speed control 

The design range of the sending speed is 5-60 words per minute. F4 slows down 
sending and F5 speeds up sending. The current WPM setting is shown in the upper 
right corner of the screen. Speed changes are allowed both while sending and not. 
Engineering standards for character timing, forming and spacing are taken from 
the ARRL Amateur Radio Handbook. 


Mouse operation- Place the mouse cursor over either of these and press the left 
button. 


6.1.1.5. F6 - Send File 

When this control is activated a pop-up window appears prompting entry of the 
name of the stored text file to be sent. Once the file is entered, Supermorse will 
begin sending the file and continue until the end of the file is reached or the 
process is aborted with F10. In the file sending mode the same adjustments are 
allowed as in the interactive mode. 


Mouse operation- Place the mouse cursor over the F6 on the screen and press the 
left button. 

6.1.1.6. F7- Save File 

Works only in file edit mode. Refer to the section for the file edit mode. 


6.1.1.7. F8 - Screen edit mode. 


This control pauses or holds sending. It allows the user to type something in first 
on the screen, and then release the screen for sending. It may also be used in a 
Start-stop manner. 


Mouse operation- Place the mouse cursor over the F8 and press the right button. 


6.1.1.8. Ctrl F8 - File edit mode 
This allows access to the built in file editor. When it is activated a pop-up message 
appears prompting the user for a filename. 


Mouse operation- Place the mouse cursor over the F8, then press the right button 
and while holding it, press the left button. 


6.1.1.9. F9 - Dir/Sys 
Permits access to operating system commands. The screen contents of the 
interactive mode is saved, and restored upon return. 


Mouse operation- Place the mouse cursor over the F9 and press the left button. 


6.1.1.10. F10 - Clear 
Immediately clears the screen and internal buffer during sending and screen 
editing. This control also terminates the file sending mode "F6". 


Mouse operation- Place the mouse cursor over F10 and press the left button. 


6.1.1.11. Alt Fl > F12 - Keyboard macro access 

These allow access to up to twelve pre-defined macro strings. The strings are 
inserted with a red background where the cursor is positioned. Once the macro 
strings are in place on the screen, they are treated exactly the same as if they were 
typed in manually. 


Supermorse displays a message in the information frame at the top center of the 
screen indicating if and how many macros are currently configured. Macro 
creation and usage is explained in detail in 6.4. 


6.1.1.12 Pop-up help screens 

Each of these pop-up help screens are available. If Supermorse is sending 
characters they will not activate. To access these during sending, use F8 to pause 
the sending first, then access the help screens. 


Alt H - Interactive sending help 
Alt C - Complete Morse code list 
Alt K - Keyboard macro usage help 


Mouse operation- There is a'Help H C K' prompt in the upper right section of the 
information frame. Place the mouse cursor on the desired one and press the left 
button. To leave help mode press the right button or any other key. 


6.1.2. Special Morse characters 

In the top part of the screen frame there are four prompts from left to right. They 
are: !=Wait, @=Error, #=Msg, and $=Wrk. Entering of these characters results in 
the following being sent: 


e The [!] sends [.-...] for wait. (AS) 

e The [@] sends [........ ] for error. (EEEEEEEE) 

e The [#] sends [.-.-.] for end of transmission. (AR) 
e The [$] sends [...-.-] for end of work. (SK) 


These sequences are sent with no spacing between the letters such as the SK 
Supermorse handles each of these as distinct character sequences. 


Mouse operation - Place the mouse cursor over any part of the text that describes 
the special Morse character and press the left button. 


6.2. Operating system shell 

Supermorse provides a method for accessing, "shelling out to" to DOS for some of 
the basic system commands without having to leave the main program. The 
operating system shell is accessed from the main screen by pressing F9. If text is 
currently being sent, you will have to either first press F10 to clear or F8 to pause, 
then press F9. 


The contents of the current screen is saved for restoration before going to the 
system shell screen. Once in the system shell mode, a user help screen may be 
accessed which explains the commands available. The help screen is accessed with 
Alt - H or placing the mouse cursor over the "H" in the "Help Alt H C K" display 
and pressing the left button. 


When the operating system shell mode is activated the screen is displayed in a sub- 
divided format with two sections. The left side is for command entry. The right 
side displays all of the files in the current working directory. 


The two main controls in this mode are | and 2. "Issue a Command", and "End 
Command Window Session". 


6.2.1. Issue a Command - | 

This opens the command window displaying a DOS prompt for command entry. It 
is at this point that one of the allowed commands is entered followed by the 
"Enter" key. 


6.2.2. End Command Window Session - 2 
Returns to the main screen of Supermorse resuming exactly as before leaving. 


6.2.3. Mouse - Place the mouse cursor over the text or number for either of these 
(6.2.1) or (6.2.2) and press the left button. 


6.2.4. Supported DOS commands 
Supermorse supports a subset of the DOS commands. The three following types of 
operating system commands allowed are listed and explained below: 


6.2.4.1. Disk drive management 

This allows changing of the current working drive. Selection of the A, B, or C 
drive is allowed. The commands are keyed in followed by 'Enter'. Allowed 
commands are: [A:], [B:], and [C:]. After the command is entered, Supermorse 
will switch to the desired drive and display the contents of the current working 
directory. 


6.2.4.2. File Management 

Allowed file management commands are [Copy], [REN]ame, and [DEL]ete. Each 
of these is available for use with files. The SOURCE file must be in the current 
working directory. The destination may be anywhere on A, B, or C. All other DOS 
conventions for these are supported. 


6.2.4.3. Directory Management 
[MD] Make Directory, [RD] Remove Directory, and [CD] Change Directory are 
fully supported. 


6.3. Built in text editor (file edit mode) 

For your connivance Supermorse has a built in text editor. Access to this mode is 
described in 6.6.1 above. The primary purpose for this editor is the creation of files 
for the "File sending mode" F6, and the keyboard macro file "HOTKEY.CNF". It 
may however be used for any other purpose. It is important to note that this is not a 
word processor. The design scope of the editor was kept within the overall 
requirements of the program. 


6.3.1. Additional information and controls 

When the edit mode is activated there are additional displays in the lower part of 
the screen frame. These displays provide system information concerning the file 
and various mode control information. 


6.3.1.1 File information 

On the far left bottom of the screen frame the name of the file that was entered 
appears. If it was an existing file, the size of the file is displayed next to the 
filename. If it is a new file, a message next to the name appears indicating so. 


6.3.1.2. Cursor position indicators and controls 
The second addition in the screen frame are the arrow indicators. These provide 
mouse control access in addition to keyboard access. 


6.3.1.3. Access to the printer 
The second additional message in the lower frame is "Print Alt-P". Pressing Alt P 
or clicking the left mouse button over this causes the file to be printed. 


6.3.1.4. Printed page indicator 

A red window appears to the right of the print control prompt indicating the 
current line and page number of where the editing cursor is. Pages are divided into 
55 lines each. 


6.3.2. Description of editing function keys: 


6.3.2.1. Insert key 

Switches between insert and overstrike modes. The mode selected is indicated by 
the cursor size. A large cursor indicates the overstrike mode. A small cursor 
indicates the insert mode. 


When characters are typed in the overstrike mode the old character is overwritten 
with the new one. When "Enter" is pressed in the overstrike mode the editing 
cursor is moved down by one line. 


In the Insert mode when characters are typed, they are inserted at the position of 
the editing cursor and the rest of the line is pushed to the right. When "Enter" is 
pressed in the insert mode an new line is inserted. 


6.3.2.2. Backspace key 
Moves the cursor to the left one position erasing the previous character. 


6.3.2.3. Delete key 
Pressing the delete key deletes the character at the editing cursor position. Pressing 
"Ctrl Del" deletes the line at the editing cursor position. 


6.3.2.4. Tab key 
This moves the editing cursor to the right five places. 


6.3.2.5. Arrow keys 

Available arrow keys are up, down, left and right. These move the editing cursor 
as such. The mouse cursor is also automatically positioned on the appropriate 
arrow in the screen frame at the bottom. 


Mouse operation - Place the mouse cursor over the desired arrow and press the left 
button. For fast positioning press the right button and then the left button 


6.3.2.6. Page keys 

These are page up and page down keys. These controls allow for scrolling through 
the file twenty lines at a time. This is the display window scrolling, not actual 
printed page scrolling. 


6.3.2.7. F7 key 
This key saves the file currently loaded into the editor to the current working drive 
under the filename specified in the lower part of the screen frame. 


Mouse operation - Place the mouse cursor over F7 or Save and press the left 
button. 


6.3.2.8. Ctrl F8 keys 
This allows termination of the edit mode. When pressed a pop-up message is 
created asking for verification, yes, or no before actually leaving the edit mode. 


Mouse operation - Position the mouse cursor over the F8 in the screen frame. First 
me man 


press the right button then the left. When the pop-up message occurs "y" or "n 
may be answered with the mouse using the left button. 


6.3.2.9. Alt P keys 

This prints the file in the editor. First the printer port is initialized and checked, 
then file printing is begun. During file printing the editing cursor is not present. 
When printing is finished, the editing cursor will return. 


If the printer is not attached or there is some fault, a pop-up message is issued 
indicating a printer fault. If this is the case, the printer is either not attached, not on 
line, or out of paper. Press any key or the left button of the mouse to return to 
editing. 


Mouse operation - Place the mouse cursor anywhere over the "Alt P Print" text in 
the screen frame and press the left button. 


6.4.0. Keyboard macros 

This is the contester's dream come true! Macros augment the interactive sending 
mode by providing twelve user configurable macro character sequences that when 
configured are assigned to each of the "Fxx" keys on the keyboard (F1-12). 
Frequently used sequences may be stored and played back during "on the air" 
operation. For example: "CQ CQ CQ DE AD4YH or "TNX FER CALL OM 
NAME HR JS ...", or "QTH HR IS RALEIGH, NC". These are just a few 
examples of some frequently used sequences. 


6.4.1. Configuring the keyboard macro feature 

The procedure for using the macro feature is simple. It may be completed ahead of 
time before running Supermorse, or may be accomplished directly within the 
Supermorse environment. 


The first step is the creation of a configuration file which contains the macro 
strings, or sequences. This file must be created and stored in the \SUPERMSE\ 
directory. To do this within Supermorse, activate the built in editor as described in 
6.3. The name of the file to create is "HOTKEY.CNF". This is the file that 
Supermorse searches for at run-time. When the file is found each of the 
appropriate function keys is configured according to the contents of the file. 


Each of the individual sequences are identified by the "@" character which must 
proceed the characters of the sequence. Supermorse searches the file for the "@" 
characters. Each time one is found the next available "F" key is loaded with the 
characters following the "@". Below is a sample "HOTKEY.CNF" file. 


@CQ CQ CQ DE AD4YH K 
@TNX FER CALL OM NAME HR IS DALE 
@QTH OTH QTH RALEIGH, NC 





@RST RST 
@WX HR IS 
@RUNNING 100 W TO 3 ELE MONO BANDER UP 45 FEET 








This sample file would configure "F" keys 1-6 in the exact order shown. The 
strings may be any length. However, the limit of the file is 1649 characters total. It 
is suggested that the strings be kept to the length of a single line each. If longer 
sequences or text is desired to be automatically sent, use the Send File mode 
instead. Remember when configuring each of the lines of text, spaces have value 
where timing between words is concerned! 


6.4.2. Activating the macros 

Once the file is created, store it, exit the edit mode, and go back to the interactive 
sending mode. Look at the center top in the information frame. Now press "Alt K". 
This will call up the help screen for this feature. The HOTKEY.CNF file will also 
be read in and the sequences assigned to each of the "F" keys accordingly. When 
the loading is complete, information concerning the number of "F" keys 
configured is displayed in the at the top center of the information frame. The 
"HOT KEY" macro sequences are now loaded and ready. Also, the next time 
Supermorse is run this will be the default hot key macro configuration file. It will 
automatically load and configure the "F" keys. 


6.4.3. Using the macro hot keys 

To use one of the configured hot keys first press one of the "Alt" keys followed by 
the "F" key desired. The string will be immediately transferred to the keying buffer 
and to the screen starting at the next available character position. The text of the 
string will be sent as though it had been typed in by hand! Macros may be 
activated at any time; during sending with unsent characters on the screen, with no 
sending taking place, or in the pause mode. 


6.5.0 Stored file sending 

Stored file sending also permits characters to be automatically sent over the air. 
Where hot keys allow for shorter more frequently used character strings, this mode 
is more for longer series of characters or a "file". 


This mode is ideal for sending bulletins or message routing. The file is prepared 
ahead of time with the Supermorse text editor or any other text editor. The file may 
be anywhere on the system hard drive or a floppy. 


First use the Dir/Sys mode to place the Supermorse system where the desired file 
is, then return back to the interactive mode screen. Next press F6. a pop up prompt 
will ask for the desired file name. Enter the filename and Supermorse will 
immediately begin sending the file at the currently set WPM rate. Supermorse will 
stay in the file send mode until it has completed sending the file or F10 (clear) is 
pressed. The selected file along with the size is displayed in the lower left hand 
information frame during sending. 


WPM, sidetone, on and off line, screen edit (pause), and F10 (Clear) are 
operational in this mode. It is suggested that these controls be preset as desired 


before the file send mode is activated. 


7.0. Supermorse transmitter interface 


Notice: 
While every effort has been taken to assure a sound design in the interface, the author 
assumes no liability for any equipment damage or injury which may result in the 


connection to electrical transmitting equipment either by the interface itself, or by how 
the Supermorse program may control it. Further, no liability is assumed where the 
interface is connected to a computer's communications port. 





7.1. Theory of operation. 

Refer to the block and schematic diagrams figures 1 and 2 below for the following 
explanation. When the "on line" mode is selected from in Supermorse the request 
to send line, (RTS) is switched on and off by the program as it sends characters. In 
other words Supermorse interfaces directly to the communications ports in your 
system. This is illustrated below in Fig | by the two blocks on the left. 


Figure | 
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* The communication port is selectable: COM1 or COM2. 


The transmitter interface connected to one of the communication ports receives 
these character switching signals. The circuit shown in figure 2 is driven by the 
switching signals. As can be seen a fast acting reed relay in the circuit provides 
100% isolation between the computer hardware and the transmitter keying circuit. 
The transistor in the circuit is a RF type, applied as a high speed solid state switch 
which drives the reed relay. 


When the communications port is not in a "key down" mode the transistor is 
negatively biased "cutoff". When the communications port keys the interface, the 
collector, emitter circuit is foreword biased, allowing the transistor to conduct in a 
highly saturated mode. When this happens the relay contacts are closed causing the 
connected transmitter to be keyed. 


It should be noted that there is no need for concern about the communications port 
setup. This is in reference to such things as baud rate, start and stop bits, parity, 
etc. These settings in the computer system have absolutely no affect on the 
function of the request to send (RTS) line. 


It sould also be noted that in the current release of this software supermorse 
also supports other interface designs that may not use the RTS line. The 
program also supports the following additional signal lines: [DTR, AUX1, 
AUX2] Just plug in your third-party interface and go! 


Figure 2 


Supermorse Transmitter Interface #1 
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7.2. Building the interface 


The circuit itself consists of only four components, two resistors, a transistor, and a 
reed relay. The part numbers shown are Radio Shack. They however are very easy 
to obtain almost anywhere. 

The circuit may be assembled on a small project breadboard, and finished up by 
placing it in a project box with the battery. One side of this box would have the 
RS232 cable from the communications port, and the other would have two 
alligator clip leads for connection to the transmitter keying circuit. 


Project Box Se 


RS232 Cable Aligator Clip Leads 
9 or 25 Pin To Transmitter Key 
Connecter Circuit 


7.3. Voltage measurements 

The following table of voltage measurements is provided for circuit checkout after 
assembly to insure proper operation of the interface. There are two sets of 
measurements: key up and key down. 


In the schematic (figure 2) above "A B C D" indicate measurement points. The 
point "B" or -V is the reference for the measurements A, C and D. E and F are the 
relay contact outputs. These would be continuity or resistance measurements. 


To perform the initial checks first install Supermorse on your computer and then 
connect the RS232 cable to one of your computer's communications ports (COM1 
or COM2). Then run Supermorse and be sure the correct port designation is 
displayed in the lower right hand portion of the screen frame. This must match the 
actual port your interface is connected to. 


Make the measurements first in the key up condition and then in the key down 
condition. If the key up measurements do not check out properly correct the 
problem first before performing the key down measurements. 


To perform key down measurements place Supermorse in the ON LINE mode, 
then in the Tune mode with the Ctrl - F'] keystroke. 


Voltage Measurements 








Pormncs KEY UP KEY DOWN 


+7.2 V 
+.75 V 
+.05 v 


Resistance Measurement 





infinite (open) 0 Ohms 





Note: Voltage measurements are approximate. Actual values found will depend on 
the individual equipment and tolerance variances in the components used in the 
transmitter interface construction. 


Alternate Interface Design: 


Below is a simplified circuit which may work in many systems. As can be seen, no 
extra battery is required. 


Supermorse Transmitter Interface #2 
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